.TH "portmenu" "1" "1.0" "Marcelo Araujo" "ports/ports-mgmt"
.SH "NAME"
.LP 
portmenu \- FreeBSD Port Management Tools.
.SH "SYNTAX"
.LP 
portmenu \fIhelp\fP
.br 
portmenu \fIhelp\fP [\fIoption\fP]
.SH "DESCRIPTION"
.LP 
This program simplifies the usual taskls related to ports tree updates.
.SH "OPTIONS"
.LP 
.TP 
\fBhelp\fR or \fBhelp\fR <\fIOPTION\fP>
Output help information options, you can join with the command option.
.TP 
\fBco\fR <\fIPORTNAME\fP>
Creates your private copy of the source <\fIPORTNAME\fP>.
.TP 
\fBup\fR <\fIPORTNAME\fP>
Execute this command when you wish to update your copies of source files.
.TP 
\fBdiff\fR <\fIPORTNAME\fP>
Check the difference between your work files and repository version.
.br 
The difference between the files is saved in ../PORTNAME.diff.
.TP 
\fBlp\fR <\fIPORTNAME\fP>
This option gets from the diff file from HOME_SITE, applies the patch, cleans up the garbage files, makes an update, runs portlint and makes a diff.
.TP 
\fBci\fR <\fIPORTNAME\fP>
Apply your changes, additions and deletions from your working directory to the repository.
.TP 
\fBch\fR <\fIPORTNAME\fP>
Update and run portlint.
.TP 
\fBgetpr\fR <\fIPRNUMBER\fP>
Makes an output file from PRNUMBER, which you can use to get the shar file or diff file included.
.TP 
\fBtakepr\fR <\fIPRNUMBER\fP>
Take a PR in GNATS for working on it.
.TP 
\fBclosepr\fR <\fIPRNUMBER\fP>
Close PRNUMBER in GNATS.
.TP 
\fBaddport\fR <\fIPORTNAME\fP> <\fICATEGORIE\fP>
Add PORTNAME to the ports tree.
.TP 
\fBrmport\fR <\fIPORTNAME\fP> <\fICATEGORIE<fP>
Remove PORTNAME from ports tree.
.TP 
\fBrepocopy\fR <\fIOLDPORTNAME/OLDCATEGORY\fP> <\fINEWPORTNAME/NEWCATEGORY\fP>
Add NEWPORTNAME into the Makefile of CATEGORY and CVSROOT/modules. Remove all entries related to OLDPORTNAME.
.SH "FILES"
.LP 
\fI/usr/local/etc/portmenu/portmenu.conf\fP 
.br 
\fI/usr/local/bin/portmenu\fP 
.SH "FILE CONF VARIABLES"
.LP 
.TP 
\fBHOME_CVS\fP
Specifies the CVS repositories.
.TP 
\fBUSERNAME_CVS\fP
Your username to access the cvs repositories.
.TP 
\fBHOME_WORK\fP
Home work directory.
.TP 
\fBHOME_SITE\fP
The home site containing the diff's files to use with lp option.
.TP 
\fBSSH_HOST\fP
FreeFall host or another shell server which has ~/bin/.

.SH "EXAMPLES"
.TP 
To work on a PORT and PR:

island$ portmenu takepr <PRNUMBER>
.br 
island$ portmenu co <PORTNAME>
.br 
island$ cd <PORTNAME>
.br 
island$ portmenu getpr <PRNUMBER> >sender.diff
.br 
island$ patch < sender.diff
.br 

.br 
# NOTE : You should clean garbage files.
.br 

.br 
island$ portmenu ch
.br 
island$ portmenu ci
.br 
island$ portmenu closepr <PRNUMBER>

.TP 
Add a new PORT into PORTS TREE:

island$ portmenu getpr <PRNUMBER> >NEWPORT.shar
.br 
island$ sh NEWPORT.shar
.br 
island$ cd <NEWPORT>
.br 
island$ portlint \-aN
.br 
island$ cd ../ 
.br 
island$ portmenu addport <PORTNAME> <CATEGORIE>
.br 
island$ pcvs ci NEWPORT ports/<CATEGORIE>/Makefile
.br 
island$ pcvs ci CVSROOT/modules

.TP 
Remove a PORT from the PORTS TREE:

island$ portmenu co <PORTNAME>
.br 
island$ portmenu rmport <PORTNAME>
.br 
island$ pcvs ci <PORTNAME> ports/<CATEGORIE>/Makefile
.br 
island$ pcvs ci CVSROOT/modules
.br 

.br 
# NOTE : You should put information about this remove into MOVED file.
.br 

.SH "AUTHORS"
.LP 
Marcelo Araujo <araujo@FreeBSD.org>
.SH "SEE ALSO"
.LP 
portlint(1), port(1), porttools(5), cvs(1)
